Skip to content

Conversation

@cotti
Copy link
Contributor

@cotti cotti commented Dec 17, 2025

Problem Overview

Certain changes in docs-builder that are best viewed from an assembler build perspective can benefit from the collective review from writers, but it's not always straightforward to share specific links, show regressions, etc.

Allowing a limited assembler preview for docs-builder pull requests would allow for earlier and broader QA, and faster communication during feature development.

Proposed solution

This PR adds a new workflow to docs-builder that builds an assembler preview to a given PR #.

It contains the following limitations:

  • Only public repositories are built
  • This process is available only on docs-builder

Other changes

llms.txt, sitemap.xml and link-index.snapshot.json generation relied on hardcoded paths, which were incompatible with the previews introduced here. If there is a path prefix available, we now make use of it.

cotti and others added 4 commits December 17, 2025 13:07
Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
@cotti cotti marked this pull request as ready for review December 17, 2025 17:11
@cotti cotti requested review from a team as code owners December 17, 2025 17:11
@cotti cotti requested a review from reakaleek December 17, 2025 17:11
Copy link
Member

@Mpdreamz Mpdreamz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! Some changes requested.

env:
AWS_RETRY_MODE: standard
AWS_MAX_ATTEMPTS: 6
ASSEMBLER_PREVIEW_PATH_PREFIX: ${{ github.repository }}/assembled-docs/${{ github.event.pull_request.number }}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
ASSEMBLER_PREVIEW_PATH_PREFIX: ${{ github.repository }}/assembled-docs/${{ github.event.pull_request.number }}
ASSEMBLER_PREVIEW_PATH_PREFIX: ${{ github.repository }}/docs/${{ github.event.pull_request.number }}

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done!

@cotti cotti requested a review from Mpdreamz December 18, 2025 16:07
@cotti cotti requested a review from Mpdreamz December 22, 2025 16:24
Copy link
Member

@Mpdreamz Mpdreamz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One nit, rest LGTM!

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
@cotti cotti requested a review from Mpdreamz December 22, 2025 21:17
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this also needs a cleanup

@cotti cotti requested a review from reakaleek December 23, 2025 13:07
@cotti cotti merged commit d08d831 into main Dec 23, 2025
37 of 39 checks passed
@cotti cotti deleted the feature/db-assembler-previews branch December 23, 2025 16:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants